home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / database / foxsqz.zip / FOXSQZ.DOC < prev    next >
Text File  |  1994-03-14  |  30KB  |  858 lines
  1. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  2.  
  3.             F O X S Q Z  Version 1.6i Mar 14, 1994
  4.  
  5.  
  6.                           DEMO/BETA
  7.  
  8. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  9.  
  10. Thank you for your interest and support of FOXSQZ !
  11.  
  12. Note :
  13.     I have removed the screen builder files along with the PLB
  14.     for FOXPRO 2.0 from the Compuserve download to conserve space,
  15.     I'm sure people were getting tired of downloading a 130K file
  16.     everytime a made a change during the BETA . All of these files
  17.     are still part of the FOXSQZ package and the Full DEMO is 
  18.     availbale on the BBS @ (201) 585-7002 .
  19.  
  20.  
  21. ***************** BETA Version Release Notes ********************
  22.  
  23. 1.5a is the currently released version.
  24.  
  25. This is a BETA version and should only be used for testing and
  26. evaluation.  v1.6 is NOT compatible with v1.5a SQZ files and visa
  27. versa. 
  28.  
  29. Do not Use SQZ files from previous versions of FOXSQZ with this BETA.
  30.  
  31. The evaluation copy is limited to storing 50 files in the SQZ
  32. file.
  33.  
  34. Registered users of v1.5 will be able to upgrade to 1.6
  35. free of charge.  A patch file will be posted on Compuserve 
  36. or may be downloaded from the BBS. 
  37.  
  38. I expect to release v1.6 by the last Week in March. 
  39.  
  40.  
  41. Known anomalies:
  42.  
  43. Specifying *.pre *.p?? will put .pre files in twice.  Just use
  44. *.p??  The problem is there is no list of files names in memory
  45. to search against. When I find an efficient way to overcome this
  46. problem it will be fixed.  Any suggestions are welcome..
  47.  
  48. When using the Store Only option with disk spanning and the files
  49. local header in the SQZ file is on a disk that is no longer in
  50. the drive the CRC for the file will not be set. This is because
  51. the Store only option writes directly to the SQZ archive
  52. bypassing the temporary file.  When this is fixed FOXSQZ will ask
  53. for a previous disk. Currently This is handled by not updating 
  54. the CRC for that file, when unstoring the CRC is ignored.
  55.  
  56.  
  57.  
  58.  
  59.  
  60. *****************************************************************
  61.  
  62. What's New !
  63. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  64. 1) You can now register FOXSQZ via Compuserve "GO SWREG" 
  65.    DOS/WIN  Version ID #1942  
  66.    DOS ONLY Version ID #2026
  67.    WIN ONLY Version ID #2037
  68.             OR
  69.    Just Search for "FOXSQZ"
  70.  
  71.  
  72. 2) Multi-volume archive support ! Foxsqz will now span SQZ
  73.    archive files across multiple diskettes if one disk is not
  74.    enough. Every last byte is used on each diskette.
  75.  
  76. 3) Ability to set the DOS Verify Flag.
  77.  
  78. 4) Store only option has been added with encryption option.
  79.  
  80. 5) Redirection of the FOXSQZ Temporary files (Go-Between file)
  81.    see option G. 
  82.  
  83. 6) Improved documentation and better documented DEMO.PRG
  84.  
  85. 7) Progress thermometer replaced by percentage complete for
  86.    compression & decompression.
  87.  
  88. 8) Option to format diskettes used in a multi-volume spanned
  89.    archive. Will only work with removable media (floppies)
  90.    supports Quick/Conditional/UnConditional Formating
  91.    of 360K/1.2MB & 720K/1.44MB formats.
  92.  
  93. 9) .SQZ Extenstion is added if none is specified
  94.     to Force no Extenstion Sepcify . after the file name with no extension
  95.  
  96. 10) A BBS system has been set up for addtional support. The Phone # is 
  97.     201-585-7002 9600,8,N,1  Xmodem is the only protocol right now. 
  98.     In a week or so I'll the others including Zmodem. The latest demos
  99.     , patches etc will be on the BBS first.  Support will continue on 
  100.     Compuserve .. Call away..
  101.  
  102. 11) $ option added will reduce memory requiremnts for M (max compression)
  103.     by 12K for low memory configurations.
  104.  
  105. 12) Still Beta Testing 
  106.  
  107. ** ATTENTION registered FOXSQZ 1.5a Users  **
  108.  
  109.     There is now a patch file to make 1.5a into 1.6i BETA to allow
  110.     you to get started with the new version the patch file may be downloaded
  111.     from the BBS call (201)585-7002 9600b 8,1,n XMODEM (for now)
  112.  
  113.  
  114.  
  115. What is FOXSQZ ?
  116. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  117. FOXSQZ is a compression/archiving system for DOS, Foxpro 2.00 &
  118. 2.5b for DOS and Foxpro 2.5b for Windows. FOXSQZ is a Foxpro
  119. Library file (PLB for DOS, FLL for Windows), a DOS command line
  120. version is part of this system as well. FOXSQZ utilizes two
  121. methods of compression. One is a very fast method with very good
  122. compression.  The other method provides better compression at a
  123. slightly slower speed. FOXSQZ requires approximately 40K of
  124. Foxpro memory resources for compression and decompression. FOXSQZ
  125. can selectively compress, decompress, list, and delete files from
  126. SQZ archives. Foxsqz can store an unlimited amount of files in
  127. one neat compact SQZ file. FoxSQZ ensures data integrity with a
  128. 16 bit CRC code and can optionally protect your data with
  129. password encryption. Foxsqz is an excellent tool for installation
  130. , backup & restore, data archiving , or any other application
  131. that may need data compression technology. 
  132.  
  133.  
  134. FOXSQZ Requirements
  135. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  136. 1) FOXPRO 2.00 or 2.5b for DOS or Foxpro For Windows v2.5b. (LAN
  137.       and (X) versions also supported.)
  138.  
  139. 2) At least 100K Foxpro memory Free (before loading FOXSQZ). 
  140.     ie) memory() >=100
  141.  
  142. 3) The need to compress your data ...
  143.  
  144.  
  145.  
  146. FOXSQZ Support Files
  147. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  148. FOXSQZ.DOC      This File.
  149.  
  150. FOXSQZ.EXE      The DOS command line version of Foxsqz. Can be
  151.                 run from DOS of a DOS Box in Windows or OS/2 > v2.0
  152.                 
  153.  
  154. FOXSQZ.PLB      Foxpro/DOS Library for Foxpro v2.5b (supports X
  155.                 version too)
  156.  
  157. FOXSQZ20.PLB    Foxpro/DOS Library for Foxpro v2.0 (supports X &
  158.                 LAN too )
  159.  
  160. FOXSQZ.FLL      Foxpro/WIN Library for Foxpro v2.5b for Windows.
  161.  
  162. DEMO.PRG        User Interface DEMO Source code for FOXPRO DOS &
  163.                 Windows requires SQZ.SPR or SQZ.SCT and SQZ.SCX.
  164.  
  165. SQZ.*           User Screen Builder file for the interface which is
  166.                 called by DEMO.PRG The interface is optional and is
  167.                 not necessary to use FOXSQZ. It provides for a 
  168.                 non-programmer to Access Foxsqz functions.
  169.  
  170. PATCH.EXE       Used to update Foxsqz when patches files are
  171.                 available.  Patch files will be posted on FOXFORUM
  172.                 (3rd Party Lib).  Or may be requested via U.S. Mail
  173.                 with a self addressed stamped envelope or disk mailer and
  174.                 one 5.25 or 3.5" Diskette there is no cost for patches. 
  175.  
  176. DEMOS\          If you have received FOXSQZ via diskette this
  177.                 directory contains DEMOS of FOXPCX, FOXGIF,
  178.                 FOXBLASTER & COMP5. DEMOS are also available on
  179.                 Compuserve "GO FOXFORUM" 3rd Party Lib.
  180.  
  181. CATALOG.DOC     Catalog of additional add-on libraries available
  182.                 for FOXPRO.
  183.  
  184.  
  185.  
  186. Quick Start
  187. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  188. Foxsqz includes an easy to use non-programmer interface. To get
  189. started right away without reading further just "DO DEMO.PRG".
  190.  
  191.  
  192.  
  193. Revisions/Fixes  History
  194. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  195. April 20, 1993 1.0 Initial BETA released on Compuserve.
  196.  
  197. April 20, 1993 - October 1, 1992  FoxSqz Development put on hold.
  198.  
  199. October 10, 1993 1.1 development resumes and released second
  200. BETA.
  201.  
  202. Nov 10, 1993 1.2 
  203.    Windows version joins in BETA 
  204.    Added data encryption can now specify destination directory
  205.    for decompressed files.
  206.    Fixed problem with uppercase in options string.
  207.    Added SQZVERS() function to return FoxSQZ version..
  208.    Source of archive file for decompression may be a in a memo
  209.    field.
  210.  
  211. Dec 8, 1993 1.3
  212.    Some minor bugs fixed.
  213.    Coded a work around to API _Fread() problem. 
  214.    Page modifier in list function works in Foxpro/DOS when paging
  215.       in a Window.
  216.    Fixed problems with encryptor.
  217.  
  218. Dec 10, 1993 1.3d
  219.    Fixed problem when compressor tries to compress large files
  220.       that do not compress well like .ZIP files.
  221.  
  222. Dec 12, 1993 1.4 (RC1)
  223.    Added exclusion file specifier see X option.
  224.    Added @ inclusion operator
  225.    Full Encryption now enabled.
  226.    Final beta (Release Candidate) before first production release
  227.       (I hope)
  228.  
  229. Dec 13, 1993 1.4a (RC2)
  230.    Options 'X' was letting 1 more than the maximum exclusion
  231.       allowed which is 5.
  232.    Spaces now allowed in options for parameter one 
  233.       ie "S c e(test) x(*.c) M"
  234.    This is not the case with the DOS version , there must be NO
  235.       spaces in the command string.
  236.  
  237. Dec 15, 1993 1.5a (First Release !)
  238.       Name specified as SQZ file is taken as is the .SQZ file
  239.       extension is no longer enforced be careful that you do not
  240.       have a data file with the same name FOXSQZ will overwrite
  241.       it! ie) If you have a data file called CLIENTS and you issue
  242.       the command "Foxsqz SC CLIENTS *.DBF"  Foxsqz will create
  243.       and overwrite the file CLIENTS.  Foxsqz will no linger
  244.       append the .SQZ file extension if you did not ask for it.
  245.       What I may do if this is a problem is add the SQZ extension
  246.       if no extension is specified.
  247.  
  248.  
  249. Jan 29, 1994 1.6 BETA  ** 1.6 Developemnt Begins **
  250.    Added disk spanning feature see option &
  251.    Added DOS verify flag option  V
  252.    New N option ,means NO-Compression (store only)
  253.    New store/un-store code that supports encryption.
  254.    G() option to redirect go-between files (Foxsqz temp file)
  255.    Fixed problem with Sqz files from DOS and foxpro not having
  256.    same CRC
  257.    Add Subdirectory support will full path names..
  258.    All of many speiling error and typos fixed. (I know how to
  259.    spell spelling) 
  260.  
  261. Feb 05, 1994 1.6 BETA 
  262.     Documented "I" (Inquire) function
  263.     Added IU option (Inquire Unsquezzed file Size)
  264.     Fixed Spanning with StoreOnly option
  265.     User is no longer prompted for Disk one.
  266.     Fixed problem with specifing source path when P option not specified.
  267.     & option cheks and will only work with Removeable Media ...(ie floppy disks)
  268.  
  269. Feb 06, 1994 1.6 BETA 
  270.     & option cheks and will only work with Removeable Media 
  271.     when combinded with W option .
  272.  
  273. Feb 16, 1994 1.6a BETA 
  274.     Added Format/Wipe support for removable spanned disk volumes
  275.     Fixed problems with Stor Option
  276.     Directory Names are no longer stored in the SQZ file by themselves.
  277.     ie) WORK\TEST\
  278.  
  279.     Passwords Expanded to 30 Characters.
  280.  
  281.     Fixed problem with restoring empty directories.
  282.     SQZ is used if no extension is specified. Specify a . after a name for no extenstion
  283.     ie) TEST. Will create SQZ file "TEST" 
  284.     Without the . TEST.SQZ will be created
  285.  
  286. Feb 28, 1994 1.6b BETA 
  287. ------------------------------
  288. Disk Spanning and Wiping automaticly turned off if target is not removable media
  289. Fixed problem with first character being chopped from file name if 
  290. a '\' was the first char in the path ie) \TEST.DBF and the P option not specified.
  291.  
  292. Mar 1, 1994 1.6c BETA 
  293. ------------------------------
  294. When Spanning Enabled to Target is Removeable a check is made 
  295. for "disk ready"
  296.  
  297.  
  298. Mar 6, 1994 1.6d BETA 
  299. ------------------------------
  300. Handle Abort/Retry error if no disk in when target is removable
  301.  
  302. a)Fixed known disk formatting problems.
  303. b)Wipe option may be specified even though spanning is not
  304.   ie) ability to format the one disk needed for backup.
  305. c) fixed problem wehre Foxsqz was ignoring abort request by user    
  306.  
  307.  
  308. Mar 7, 1994 1.6e BETA 
  309. ------------------------------
  310. Fixed problem with operations on spanned archives. Due to 
  311. struct alignment problem.
  312.  
  313.  
  314. Mar 8, 1994 1.6f BETA 
  315. ------------------------------
  316. Fixed problem with not putting correct disk in sequence first time around
  317. Fixed problem with FoxSqz occasionaly leaving a file open.
  318. L I options now check for disk ready.
  319.  
  320. Mar 10-12 1994 1.6g-h BETA 
  321. ------------------------------
  322. Fixed memory problems.
  323.  
  324.  
  325. Mar 14, 1994 1.6i BETA 
  326. ------------------------------
  327. Added memory conservation option $.
  328. Began cleaning up FOXSQZ messages.
  329. Working on more examples and explanations in the DOCS. 
  330.  
  331.  
  332. Support
  333. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  334. If you have any questions and or suggestions please send EMAIL to
  335. (CIS) 70713,2002 or leave a message on the BBS (201) 585-7002.
  336. The BBS and EMAIL is checked everyday. Updates to registered
  337. copies of FOXSQZ will be available a a patch files on FOXFORUM 
  338. and the BBS when they become available.  All Suggestions/comments
  339. are welcome and, of course, appreciated.
  340.  
  341.  
  342.  
  343. WARRANTY AND LEGAL STUFF
  344. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  345. FOXSQZ is Copyright (c) 1993-94 Master Creative Software, Inc.
  346. All Rights Reserved .
  347.  
  348. One registered version of FOXSQZ entitles a person to use FOXSQZ
  349. on one machine at a time. Very reasonable and flexible
  350. distribution options are available.
  351.  
  352. There is no warranty or guarantees of any kind associated with
  353. FOXSQZ.  Master Creative Software, Inc. and the author of FOXSQZ
  354. will assume NO responsibility for ANY damage or loss caused by
  355. the use of FOXSQZ however it may happen and whatever may happen. 
  356.  
  357. Master Creative Software, Inc. and the author of FOXSQZ will not
  358. be liable for any damages whatsoever due to loss of data or any 
  359. other reason, even if they have been advised of the possibility
  360. of such damages. 
  361.  
  362. Any risk of damage due to any possible inaccurate information or
  363. a misunderstanding of the provided information is assumed by the
  364. user of the information.
  365.  
  366. By registering and/or using FOXSQZ, you agree to these terms.  
  367.  
  368. That's it ...
  369.  
  370.  
  371.  
  372. How Much does it cost ?
  373. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  374. Introductory Offer !
  375.  
  376. a Developer registration fee (DOS OR WINDOWS) is U.S. $69.00 ea.
  377. (includes DOS EXE version)
  378.  
  379. ADD $35.00 to receive both versions FOXPRO DOS & WINDOWS. (a
  380. savings of $34.00)
  381.  
  382. When Registering via Compuserve the costs are a little more due
  383. to the fact that they keep 15%. It's roughly $10.00 more.
  384.  
  385.  
  386. Multiple Copy Distribution:
  387. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  388. Requires at least one registered developer copy plus $3.00/copy
  389. up to a maximum of 100 copies. When 100 copies are registered at
  390. the $3.00/copy then distribution is unlimited and royalty free.
  391.    
  392. *One Unlimited distribution license entitles you unlimited
  393. distribution of both DOS & Windows Versions !
  394.  
  395.  
  396. Distribution
  397. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  398. This Software may be distributed with your application in a bound
  399. EXE or APP in FOXPRO/DOS or as the unmodified FLL file for
  400. FOXPRO/WINDOWS. The DOS EXE version may be distributed as is. If
  401. you have properly registered I do not require any credit(s) in
  402. your app for FOXSQZ.
  403.  
  404.  
  405. How To Receive FOXSQZ
  406. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  407. You can receive FOXSQZ by sending the order form below with a
  408. Check or Money Order Only , payable to Master Creative Software,
  409. Inc. in U.S Funds for the total amount.   * Please specify
  410. DOS/WINDOWS or both.. *
  411.  
  412. Mail to: Master Creative Software, Inc.
  413.          1530 Palisade Avenue
  414.          Suite 16C   
  415.          Fort Lee, N.J. 07024
  416.  
  417.  
  418.  
  419. ** Registration on Compuserve  **
  420.  
  421. You can also register FOXSQZ via Compuserve shareware database.
  422. GO SWREG when registering via Compuserve the charge will billed to your
  423. Compuserve account.  DOS/WIN  Version ID #1942 
  424.                      DOS ONLY Version ID #2026
  425.                      WIN ONLY Version ID #2037
  426. Multiple distribution licenses are available separately..
  427.  
  428.  
  429. --------------------- FOXSQZ ORDER FORM -------------------------
  430.  
  431. Where did you obtain FOXSQZ?
  432.  
  433. Compuserve  [  ]    Your I.D. # _____________
  434.  
  435. BBS         [  ]    Which BBS  ______________ 
  436.  
  437.                     Phone#?    ______________
  438.  
  439. Friend      [  ]    ?          ______________ 
  440.  
  441.  
  442. How would you like Foxsqz Sent ? There are two choices:
  443.  
  444. 1) [ ] EMAIL to Compuserve I.D ________________________ (usually
  445.        same-day delivery $1-2 extra charge billed to your CIS account)
  446.  
  447. 2) [  ] Download From BBS  (Fill in Address Info Below and a Account
  448.                             will be set up for you on the BBS)
  449.         Password you would like for BBS __________________ 
  450.  
  451. 3) [  ] Send via U.S. Mail  
  452.  
  453. Company          ______________________________________________ 
  454.  
  455. Name             ______________________________________________ 
  456.  
  457. Address          ______________________________________________ 
  458.  
  459. City State Zip   ______________________________________________ 
  460.  
  461. Country          ______________________________________________  
  462.  
  463. Phone/Fax         ______________________________________________  
  464.  
  465.  
  466. SINGLE COPY REGISTRATION
  467.  
  468. qty ordered: ____ @ $______ $69.00 ea. Specify FOX/DOS or
  469.                               FOX/Windows Version.  Either version
  470.                               comes with a DOS Exe.
  471.                     $______ $25.00 add to receive FOXSQZ for both
  472.                               platforms DOS & WINDOWS (save $44.00).
  473.  
  474. MULTIPLE COPY REGISTRATION ADD
  475.  
  476. ____ copies @ $3.00 per copy.  Maximum 100 copies.  There is no
  477.    additional cost for distribution once the maximum 100 copies
  478.    have been registered.  1 Developer + 100 copy registrations
  479.    entitles you to unlimited distribution. (valid for both DOS
  480.    and Windows versions).
  481.                               
  482.              Total: $_________   Payable in U.S. Funds 
  483.  
  484.  
  485. Master Creative Software, Inc. and the author of FOXSQZ can be
  486. reached via CIS MAIL the I.D. is 70713,2002 and they monitor the
  487. FOXForum daily.  FOXSQZ can be shipped via U.S. Mail or CIS EMAIL
  488. (which is same day) Or Call the BBS at 201-585-7002 .
  489.  
  490.  
  491. Acknowledgments
  492. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  493. I would like to thank Peter Abramson and Bob Velke for their 
  494. thorough and rigorous testing and invaluable suggestions.
  495. Foxsqz would not have been possible without the help of these two 
  496. gentlemen. I must also not forget my wife Victoria and my 1 year old
  497. daughter Rachael for putting up with me (mostly without me) during 
  498. the development of FOXSQZ.
  499.  
  500.  
  501.  
  502.  
  503. Usage:
  504. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  505. Set Libr to FOXSQZ  
  506.  
  507. From this point on FOXPRO now knows how to compress and
  508. decompress files without using the run/! command to shell out to
  509. DOS and call an external DOS program.
  510.  
  511. Syntax:
  512.  
  513. =SQZVERS() Returns the Current FOXSQZ Version...
  514.  
  515. =FOXSQZ([S[cfmnrp@x&w(lu)]QVG()L[p]U[or]I[csu]E[(pass)]D[a]
  516.         T[(TargetDir)],SQZFile,Files)
  517.  
  518. The above mess is not as bad as you may think, take a look at the
  519. code in DEMO.PRG for a quick way of building parameter lists for
  520. FOXSQZ on the fly.
  521.  
  522. FOXSQZ Function Types and modifiers
  523. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  524.  
  525. Modifiers used in all or most functions
  526. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  527. Q -  Quiet Mode No Screen OutPut
  528.  
  529. X - Exclude File Specifier
  530.     You may specify up to 5 exclude file specifications.  The
  531.     syntax is X(filespec) ie) X(*.c)X(*.bak).  The Exclusion
  532.     operators work with S U L D I Functions..
  533.  
  534. V - The verify flag controls output to the disk. 
  535.     When verify is off, writes are not verified; when verify is
  536.     on, all disk writes are verified to insure proper writing of
  537.     the data.  By default Foxsqz uses the default DOS verify flag
  538.     for the system the V option forces it true and restored it
  539.     upon completion.  This option will slow down file writes..
  540.  
  541. G - The drive specifier to place the Foxsqz Go-Between temp file.
  542.     This will speed up file compression especially on Stacker
  543.     drives. syntax G(d:) where d: is the drive to place the File
  544.     (ram disk is best)
  545.  
  546. E - Encrypt/DeCrypt Data in Archive
  547.     When Compressing files this option will add a password to the
  548.     archive file.  The password may be a max of 30 characters.
  549.     When calling any other function on a encrypted SQZ file you
  550.     must specify the password for the function to successful. 
  551.  
  552.     ie) FOXSQZ("SCE(FoxPro)Z","TEST","*.C")
  553.  
  554.     Compress *.c and encrypts the data with the password FoxPro
  555.     (case matters !)
  556. S - Squeeze Function
  557. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  558.  
  559. S Modifiers.
  560. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  561. 'C' : Create Mode (only one supported Update feature scheduled for v1.7) .
  562.       The Squeeze function will create a SQZ file and compress
  563.       files into it.
  564.  
  565. 'M' : Maximum Compression. 
  566.  
  567. 'F' : Fast Compression. This is the default and does not need to
  568.       be specified.
  569.  
  570. 'N' : No Compression. Stores files in the archive as is  .
  571.  
  572. '@' : File list inclusion operator.
  573.       You may specify 1 include file. A include file is a text
  574.       file containing file specifiers. Any other file specifies
  575.       are ignored (parameter 3) The syntax is @(FileSpec) ie)
  576.       @(data.inc).  The include file may contain any valid dos
  577.       file names or wildcards ONE Per Line!  Each line must be
  578.       terminated with a Cr/Lf pair  most text editor do this for
  579.       you..
  580.  
  581. '&' : Archive to span multiple removable media (ie floppies)
  582.  
  583. '$' : Save precious memory when using M (max compression ) option.
  584.       saves approx 12K of Foxpro memory which reduced compression
  585.       by only about 3. Saves approc 3.5K with F(ast) option
  586.  
  587. 'W' : Wipe spanned (REMOVABLE) media before writing. 
  588.       
  589.  
  590.       Wipe/Format Modifiers
  591. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  592.       Q = Quick format The Disk, methods rewrites the 
  593.           disk bootsector/FAT and directory. This is 
  594.           the default. If unable to quick format a disk
  595.           Foxsqz will try a Conditional Format. 
  596.  
  597.       C = Conditionally format the target. regardless if
  598.             the disk was previously formated or not This method.
  599.           will first try to Verify that the disk has been formated
  600.           by checking for a valid boot sector, it al is well
  601.           it will verify all of the tracks. If this function fails
  602.           Foxsqz will attempt a unconditional format.
  603.  
  604.       U = Unconditionally format the target. regardless if
  605.             the disk was previously formated or not. This method
  606.           performs a full low level format of the drive.
  607.  
  608.       L = Specify low density if using low density media in a
  609.             high density drive ie) 720K diskette in 1.44MB drive
  610.                                  360K diskette in 1.2MB drive.
  611.  
  612.       * if W is specified with no modifiers the default is High Density
  613.           Conditional Format..
  614.  
  615.       * FOXSQZ will NOT attempt to format media in a Non-Removable
  616.         drive, namely Hard-Disks    ..
  617.  
  618.       *    if Disk Spanning and/or Wiping is specified and the target is 
  619.         NON-Removable FOXSQZ will automaticly disable disk spanning and
  620.         disk wiping.
  621.                      
  622.           example) Foxsqz Sc&w(lu) b:test.sqz *.c *.h
  623.  
  624.           will unconditionally format the diskettes in drive B: at
  625.           low density.
  626.  
  627.  
  628. 'R' : recurse into subdirectories
  629.       FoxSqz will look into subdirectors for files that match the
  630.       file specifier.
  631.  
  632. 'P' : store the recursed into directory
  633.       Foxsqz will store the filename with it's path for directory
  634.       tree restoration later when decompressing.
  635.  
  636.         example) FOXSQZ SCRP C:\WORK\ALBANY\*.pre
  637.         
  638.       a file named C:\WORK\ALBANY\PRE\ALBANY.PRE will be stored
  639.       as PRE\ALBANY.PRE.
  640.  
  641. 'P* :store the specified and recursed into directories.
  642.  
  643.       example) FOXSQZ SCRP* C:\WORK\ALBANY\*.pre
  644.  
  645.       a file named C:\WORK\ALBANY\PRE\ALBANY.PRE will be stored
  646.       as WORK\ALBANY\PRE\ALBANY.PRE
  647.  
  648.  
  649.  
  650. U - Un-Squeeze Function
  651. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  652.  
  653. U Modifiers.
  654. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  655.  
  656. 'O' : OverWrite Option
  657.       The overwrite option instructs FoxSQZ to Overwrite files
  658.       that are already on disk. Otherwise if the file already
  659.       exists it will prompt you for overwrite permission.
  660.  
  661. 'R' : Restore Original Date Time
  662.       This option instructs FOXSQZ to restore the original date
  663.       and time to the file when it was compressed. Otherwise the
  664.       current date and time are used.
  665.  
  666. 'T' : Target Directory
  667.       Specify the Target Drive and/or Path that the files should
  668.       be decompressed to. The destination Drive path MUST be
  669.       enclosed in parenthesis and directly follow the T modifier
  670.       in the command string.
  671.  
  672.       example : UT(C:\Work\Fox\API\)O  
  673.  
  674.       ** NOTE ** the trailing Backslash is Needed! 
  675.  
  676.  
  677.  
  678. 'D' : Restore Directory orginal paths
  679.       This option instructs Foxsqz to Put files into the orginal directory
  680.       that they orginated from if the P modifer was used when compressing.
  681.       without this option Foxsqz will place all the files in the same directory.
  682.  
  683.  
  684. D - Delete Files from SqzFile
  685. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  686.     Deletes the Specified Files from the SQZ file
  687.  
  688.  
  689. L - List Files in Archive File
  690. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  691.       Displays files in a SQZ file. Lists the File name,original
  692.       size, compressed size, CRC value and Compression ratio.
  693.  
  694. L - Modifiers.
  695. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  696.  
  697. 'P' : PageDisplay, This option instructs FOXSQZ to page the
  698.       display of files (works like More filter in DOS)
  699.  
  700.  
  701.  
  702. I - Inquire Function
  703. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  704. FOXSQZ will return an integer based on the I Modifier
  705. The Default I modifier is "C"
  706.  
  707. I Modifiers.
  708. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  709. 'S'  - Return the Total Squeezed File Size for files matching file specifier.
  710. 'U'  - Return the Total Un-Squeezed File Size for files matching file specifier.
  711. 'C'  - Return the Total Count of files for files matching file specifier.
  712.  
  713. Example:
  714.     if FOXSQZ("IU","TEST.SQZ","*.dbf *.fpt") > DISKSPACE()
  715.         Wait "Not Enough DiskSpace for Decompression of Specified Files" Window
  716.     Endif
  717.  
  718.  
  719.  
  720. SqzFileName Parameter (2)
  721. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  722. The archive name may be any character string or variable name
  723. that can represent a valid DOS file name. 
  724.  
  725. ie) "DEMOS.SQZ" "FILES"  TEST. TEST
  726.     *note: TEST. becomes TEST and TEST becomes TEST.SQZ
  727.  
  728.  
  729. FILESPEC Parameter (3) Optional
  730. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  731. The file specifier may be any valid DOS file name. Wildcard
  732. characters are supported. You may specify up to 10 different file
  733. specifiers 
  734.  
  735. ie) "TEST.PRG *.prg "?.c *.h " If this parameter is omitted (*.*)
  736. is assumed.
  737.  
  738.  
  739. Programming Examples
  740. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  741.  
  742. Set Libr to FoxSqz  && Make FoxSqz a part of FOXPRO
  743.  
  744. =FoxSqz("SCM","TEST.SQZ","*.c *.h *.asm")  
  745.       Create SQZ file TEST.SQZ using maximum compression.
  746.       Compress files *.c *.h and *.asm into test.sqz.
  747.  
  748. =FoxSqz("SC","TEST","*.c *.h *.asm")  
  749.       Create SQZ file TEST using fast compression.
  750.       Compress files *.c *.h and *.asm into test.sqz.
  751.  
  752. =FoxSqz("SC","TEST.SQZ")  
  753.       Create SQZ file TEST.SQZ using fast compression.
  754.       Compress all files in current directory.
  755.  
  756. =FoxSqz("d","TEST.WAR","Lzw.c")
  757.       Delete the File lzw.c from TEST.WAR.
  758.  
  759. =FoxSqz("lp","TEST.SQZ","*.c")
  760.       List all .c file from TEST.SQZ one page at a time.
  761.  
  762. =FoxSqz("uot(c:\work\)","TEST")
  763.       De-compress all files from TEST.SQZ overwriting any files
  764.       with the same name and placing them in the C:\WORK
  765.       directory.
  766.  
  767. =FoxSqz("uo","TEST.SQZ","*.c")
  768.       De-compress all .c file from TEST.SQZ overwriting any files
  769.       with the same name.
  770.  
  771. =FoxSqz("scmq","c:\arc\TEST.sqz","c:\work\data\*.dbf
  772. c:\work\source\*.pre")
  773.       Compress files indicated into a sqz file in the c:\arc
  774.       subdirectory.
  775.  
  776. =FoxSqz("scmqX(a*.*)","c:\arc\TEST.sqz","c:\work\data\*.dbf
  777. c:\work\data\*.fpt")
  778.       Compress files indicated into a sqz file in the c:\arc
  779.       subdirectory and eXclude files that begin with 'a'.
  780.  
  781. =FoxSqz("s@(test.inc)","Test")
  782.       Compress files that are listed in test.inc into a sqz file. 
  783.       Test.inc might contain:
  784.           *.c
  785.           c:\work\data\*.dbf
  786.           c:\work\data\*.fpt etc...
  787.  
  788. =FoxSqz("s&v","A:Test.SQZ","*.dbf *.fpt")
  789.       Compress All DBF and FPT to Floppy in Drive A:. TEST.SQZ
  790.       will span multiple floppies if data is larger than one
  791.       floppy disk.
  792.  
  793. =FoxSqz("scrp","Test.SQZ","*.dbf *.fpt")
  794.       Compress All DBF and FPT that appear in the current
  795.       directory and all subdirectories below, store path names in
  796.       the SQZ file.
  797.  
  798. =FoxSqz("up","Test.SQZ")
  799.       Decompress All files in Test.Sqz creating the directory
  800.       tree if p option was used when compressing..
  801. /* Codes Returned by FOXSQZ  */
  802.  
  803. *See The Error Function in Demo.prg
  804.  
  805.    0   No Errors Detected
  806.    1   Bad Input
  807.    2   Bad Output
  808.    3   Bad Global Header
  809.    4   Error Writing Global Header
  810.    5   Bad Local Header
  811.    6   Error Writing Local Header
  812.    7   Error Allocating memory
  813.    8   Error Allocating memory
  814.    9   File Read Error 1
  815.   10   File Read Error 2
  816.   11   File Read Error 3
  817.   12   DosFile Size Error
  818.   13   File Write Error 1
  819.   14   File Write Error 2
  820.   15   File Write Error 3
  821.   16   Error In Parameter 1
  822.   17   Error In Parameter 2
  823.   18   Error In Parameter 3
  824.   19   Error Opening Input
  825.   20   Error Opening OutPut
  826.   21   No Parameters Passed
  827.   22   Error Opening WorkFile
  828.   23   File Write Error
  829.   24   Create Aborted By User
  830.   25   Error Allocating Memory
  831.   26   Error InValid Parameter
  832.   27   UnKnown compression type
  833.   28   Error in Password
  834.   29   InValid PassWord 
  835.   30   Not a FOXSQZ Archive or Incompatible version
  836.   31   Error Changing to drv/path
  837.   32   Unable to select target
  838.   33   Could not Open Include File
  839.   34   Invalid Inclusion argument
  840.   35   Invalid Exclusion argument
  841.   36   Max Exclusions is 5
  842.   37   Not disk one in sequence
  843.   38   User aborted
  844.   39   No Spanning for this option
  845.   40   Unable to Format Disk
  846.   41   Nothing to do
  847.   42   Exceeded max files allowed in demo
  848.   43   Disk is Not Removable
  849.   44   No More Internal FoxSqz Memory Handles
  850.   45   Invalid Drive Specified
  851.  
  852.  
  853.  
  854. Please send any and all comments and suggestions to CIS 70713,2002
  855. or Feel free to call the BBS at 201-585-7002..
  856.  
  857. Thank You...
  858.